第 1 步 - 创建含 C++ 应用程序的工程并打印到调试控制台

这一步中，首先使用 C++ 应用程序创建新的Kanzi Studio 工程。然后将代码添加到 C++ 应用程序中，打印 Hello world! 到 Kanzi 调试控制台中。

<KanziWorkspace>/Tutorials/Hello world/Completed 目录包含本教程已完成的工程。

创建含 C++ 应用程序的工程并打印到调试控制台

要创建含 C++ 应用程序的工程并打印到 Kanzi 调试控制台：

  1. 在Kanzi Studio 快速启动 (Quick Start)窗口点击新建工程 (New Project)：
    1. 选择工程名称和位置。
      例如，将工程命名为 Hello world。
    2. 将模板 (Template) 设为应用程序 (Application)。

    Kanzi 在 <KanziWorkspace>/Projects/<ProjectName>/Tool_project 目录中创建 Kanzi Studio 工程，并在 <KanziWorkspace>/Projects/<ProjectName>/Application 中创建工程的 Visual Studio 解决方案的结构：

  2. 在Kanzi Studio 中选择文件 (File) > 导出 (Export) > 导出 KZB (Export KZB)。
    Kanzi Studio 从 Kanzi Studio 工程创建 kzb 文件和配置文件。Kanzi Studio 将导出的文件存储在 <ProjectName>/Application/bin 目录或您在 工程 (Project) > 属性 (Properties) 的二进制导出目录 (Binary Export Directory) 属性中指定的位置。Kzb 文件包含 Kanzi Studio 工程中的所有节点和资源，您在本地化表中标记为本地化包的资源除外。
    当您从 Visual Studio 中运行您的 Kanzi 应用程序时，您的应用程序就会加载 kzb 文件和配置文件。
  3. 在 Visual Studio 中，为您的应用程序打开位于 Application/configs/platforms/win32 的 Visual Studio 解决方案。
    例如，如果您将 Kanzi Studio 工程命名为 Hello world，则 Visual Studio 解决方案称为 Hello_world.sln。
    注

    如果您在 Visual Studio 2017 中打开教程解决方案，遇到提示您重新定位工程到最新的 Microsoft 工具集时，请点击取消 (Cancel)。

    建议

    要从 Kanzi Studio 打开 Kanzi Studio 工程的目录，选择文件 (File) > 在 Windows 资源管理器中打开 (Open in Windows Explorer)。

  4. 在 Visual Studio 的 Solution Explorer 中，右键点击 Hello_world 工程并选择设为启动工程 (Set as StartUp Project)。
  5. 在 Visual Studio 中，打开 hello_world.cpp 文件。
    应用程序类使用 ExampleApplication类，通过处理所需模块的注册简化应用程序开发。
    #include <kanzi/kanzi.hpp>

using namespace kanzi;

class HelloWorld : public ExampleApplication
  6. 包含 log.hpp 头文件，使用记录器打印到 Kanzi 调试控制台：
    #include <kanzi/core/log/log.hpp>
  7. 当您将函数置于 onProjectLoaded() 内，Kanzi 会在您加载应用程序后调用该函数。
    virtual void onProjectLoaded() KZ_OVERRIDE
{
    //将 Hello world! 打印到 Kanzi 调试控制台。
    kzLogInfo(KZ_LOG_CATEGORY_GENERIC, ("Hello world!"));
}
  8. 在 Visual Studio 中，为您的 Visual Studio 版本选择一个解决方案配置并运行应用程序。
    例如，如果您仍在开发应用程序，选择GL_vs2015_Debug 配置。要创建 Kanzi 应用程序的产品版本，选择一个可用的发布配置。

    函数 kzLogInfo 将 Hello world! 打印到 Kanzi 调试控制台。

    在调试模式中，伴随 Kanzi 调试控制台，Kanzi 应用程序显示在 Kanzi 播放器中。由于新 Kanzi Studio 工程默认仅包含一个带有摄像机和方向光的场景，应用程序会显示空场景。

这是您在完成本步骤之后，您的 hello_world.cpp 的外观。

#include <kanzi/kanzi.hpp>
#include <kanzi/core/log/log.hpp>


using namespace kanzi;

class HelloWorld : public ExampleApplication
{
public: 

    virtual void onConfigure(ApplicationProperties& configuration) KZ_OVERRIDE
    {
        configuration.binaryName = "hello_world.kzb.cfg";
    }

    virtual void onProjectLoaded() KZ_OVERRIDE
    {
        //工程文件是从 kzb 文件加载的。
        kzLogInfo(KZ_LOG_CATEGORY_GENERIC, ("Hello world!"));
        //在此处添加初始化代码。
    }
};

Application* createApplication()
{
    return new HelloWorld;
}

< 简介
下一步 >

另请参阅

API reference

打开导航